home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / lcnt150u.zip / LOGCOUNT.CFG < prev    next >
Text File  |  1992-11-27  |  38KB  |  736 lines

  1. %
  2. % --------------------------------------------------------------------------
  3. % --------------------------------------------------------------------------
  4. %  NOTE: This sample file contains lots of information that is purely
  5. %        descriptive and commentary. the actual .CFG file need only
  6. %        contain the runtime parameters. This will speed up processing
  7. %        if LOGCOUNT does not have to ignore all the non commands.
  8. %        Parameters can be placed in any order and are case insensitive.
  9. %
  10. %  ALSO NOTE: This program uses the default characters '[' and ']' to
  11. %             contain the download information. If you have been using
  12. %             another utility which uses '(' and ')' then investigate
  13. %             the -X and -Y options, if you run the program without
  14. %             proper configuration, your FILES.BBS will be altered and
  15. %             the descriptions will be truncated. Be Careful.
  16. %
  17. %
  18. %
  19. % --------------------------------------------------------------------------
  20. % --------------------------------------------------------------------------
  21. %
  22. %   LOGCOUNT.CFG Format, all command line options start with '-' or '/',
  23. %   all other lines are ignored. Commands in the .CFG file are exactly
  24. %   the same as command line options, NO SPACES are permitted between
  25. %   the identifier and the parameter. The first 'word' on the line must
  26. %   be the 'identifier/parameter' and any other 'words' will be ignored.
  27. %   You can put comments of the same line as your command line options.
  28. %   Just make sure that at least TWO space character separates the command
  29. %   line parameter from the description. LOGCOUNT will look for LOGCOUNT.CFG
  30. %   in the executing directory if no command line -C<config.CFG> has been
  31. %   specified. It will use any parameters found in it, any other command
  32. %   line options will override what is in the .CFG file.
  33. %
  34. %   When LOGCOUNT is processing a FILES.BBS file, any blank lines, lines
  35. %   that begin with a space (ascii 32) of a hyphen '-' or a  '@' symbol
  36. %   will be considered a 'comment' line, and will be ignored, any other
  37. %   character as the first character of a line will be treated as a
  38. %   filename. If no inclusion is contained in the line, then one will
  39. %   be added, don't put comments starting at the first character of the
  40. %   line, CBCSystems don't like it, and neither will LOGCOUNT.
  41. %
  42. %
  43. %
  44. %
  45. %----------------------------------------------------------------------------
  46. %
  47. %
  48. %  -L Parameter -=> CBCS Log file to be read. A Maximus/Opus .LOG File
  49. %                   or a QBBS system log file.
  50. %
  51. %                   full drive/path/filename is optional, if no path is
  52. %                   given then the current directory will be searched for
  53. %                   file.
  54. %
  55. % --------------------------------------------------------------------------
  56. %
  57. %  -B Parameter -=> BinkleyTerm format Logfile. (drive/path optional).
  58. %
  59. % --------------------------------------------------------------------------
  60. %
  61. %  -F Parameter -=> FrontDoor/RA format Logfile. (drive/path optional).
  62. %
  63. %
  64. %   Note:  Since these two 'different' format files use the same parameter
  65. %          the last run information may not always be valid. If you run
  66. %          Logcount on two different log files in the same directory, then
  67. %          the last run information will certainly not be valid. Try moving
  68. %          either your FD or RA logfile to another directory before running
  69. %          LOGCOUNT on your second logfile.
  70. %
  71. % --------------------------------------------------------------------------
  72. %
  73. %  -D Parameter -=> history Download file. (if you specify a -D option
  74. %                   in the .CFG file and then specify a '-D' parameter
  75. %                   with no filename then this will turn off the download
  76. %                   history file option. If used with -B option then all
  77. %                   files 'sent' will be logged, Netmail etc.. will not
  78. %                   be logged.
  79. %
  80. % --------------------------------------------------------------------------
  81. %
  82. %  -U Parameter -=> history upload file. (if you specify a '-U<filespec>'
  83. %                   parameter in the .CFG file and then specify a '-U'
  84. %                   parameter with no filename then this will turn off
  85. %                   the uploads  history file option. If used with the
  86. %                   -B or -F options ALL files uploaded (received) will
  87. %                   be logged.
  88. %
  89. %       NOTE: Both the -D<log_file> and the -U<up_file> can be pointed
  90. %             to the same file, this keeps everything together, I prefer
  91. %             to keep one complete history log, but to each his/her own.
  92. %             .REQ files will only be logged if both history logs point
  93. %             to the same file, otherwise .REQ files are not reported in
  94. %             the '-U' upload (request) history file.
  95. %
  96. %
  97. % -J<filename> CBCSlogFile option, filenames that match will update the
  98. %              files.bbs if that option is active. These filenames will not
  99. %              be entered in any history logfiles.  Wildcards '?' can be used,
  100. %              doesn't support '*' wildcards. The name will be checked
  101. %              character by character. Maximum 25. Simple names only,
  102. %              no path info...
  103. %
  104. %              eg.  -jnodediff.a??
  105. %              eg.  -jfnews???.arc
  106. %              eg.  -jMaximus.Qwk
  107. %              eg.  -jMaximus.Rep
  108. %
  109. % --------------------------------------------------------------------------
  110. %
  111. %  -K parameter -=> intructs LOGCOUNT *not* to include the remote system's
  112. %                   SysOp's name in the history files. Only applicable if
  113. %                   processing a `-b' Binkleyterm or `-f' FD log file.
  114. %
  115. %                   this might be needed for a `-f' DB log! DB logfile
  116. %                   is not very well known by author of LOGCOUNT.
  117. % --------------------------------------------------------------------------
  118. %
  119. %  -E parameter  -=> This parameter indicates exactly what type of
  120. %                    'Time of Transfer' information to include in your
  121. %                    history log files. The default is to have NONE.
  122. %                    The date of 'transfer' is always included.
  123. %
  124. %             -EH    Will only include the Hour of the transfer.
  125. %             -EHM   will include the Hour and the Minutes,
  126. %             -EHMS  will include the hour, minutes and seconds.
  127. %
  128. %
  129. % --------------------------------------------------------------------------
  130. %
  131. %  -X Parameter -=> custom bracket character for left bracket.
  132. %                   the default is '-x[' and not '-x(' !!!!!!!!!!
  133. %
  134. %               -=> can contain 'invisible' Avatar Colour codes.
  135. %                   maximus length of 24 characters.
  136. %
  137. %  -x[, <       -=> enhanced function, normal files use '[', free files
  138. %                   counts will be enclosed by '<' character.
  139. %
  140. % --------------------------------------------------------------------------
  141. %
  142. %  -Y Parameter -=> custom bracket character for right bracket.
  143. %                   the default is '-y]' and not '-y)' !!!!!!!!!!
  144. %
  145. %               -=> can contain 'invisible' Avatar Colour codes.
  146. %                   maximus length of 24 characters.
  147. %
  148. %  -x], >       -=> enhanced function, normal files use ']', free files
  149. %                   counts will be enclosed by '>' character.
  150. %
  151. %
  152. %     Note:    This is the only way to pass Characters that DOS will
  153. %              interpret as Redirection commands. '>', '<', and '|',
  154. %              can't be passed from the DOS Command line.
  155. %
  156. %     If you change 'bracket' characters, then you will have to use
  157. %     a text editor to make GLOBAL changes, the program will not do
  158. %     that for you, if you run the program on an existing files.bbs
  159. %     that uses a different format from the default or the configured
  160. %     setup, things will get real messy ! Filename.ext [ ] (45) description
  161. %     will be the result, you have been warned ! FIXFBBS can do this,
  162. %     but be sure to backup your FILES.BBS files before experimenting
  163. %     with FIXFBBS and AVATAR codes. If you use the enhanced function
  164. %     make sure FIXFBBS and LOGCOUNT have been configured with the
  165. %     same information. Failure to do this will result in disaster..
  166. %
  167. % --------------------------------------------------------------------------
  168. %
  169. %  -R Parameter -=> Identifies what a  RECEIVED entry looks like.
  170. %                   By default this is 'UL-?' for CBCS, 'Rcvd' for FD and
  171. %                   'Received-Z/32' for BinkleyTerm. Change this for NoWazoo
  172. %                   entries. this parameter is case sensitive and must be
  173. %                   exactly as it appears in the .LOG file.
  174. %
  175. %+ 05 May 00:29:46 BINK Received-Z/32 C:\Opus\Inbound\00000064.sa0
  176. %                       ^^^^^^^^^^^^^
  177. %    example          -RReceived-Z/32
  178. %
  179. %  SPECIAL NOTE: in order for this option to work correctly you must
  180. %                have your logfile options specified in the .cfg file
  181. %                *before* this option. Command line overrides for log
  182. %                file options also will override this option.
  183. %
  184. %  NOTE: Not available as a command line option.
  185. % --------------------------------------------------------------------------
  186. %
  187. %  -S Parameter -=> Identifies what a  SEND entry looks like.
  188. %                   By default this is 'DL-?' for CBCS, 'Sent' for FD and
  189. %                   'Sent-Z/32' for BinkleyTerm. Change this for NoWazoo
  190. %                   entries. This parameter is case SENSITIVE and must be
  191. %                   exactly as it appears in the .LOG file.
  192. %
  193. %+ 05 May 00:28:27 BINK Sent-Z/32 C:\Opus\Outbound\0000ff9c.Fr0
  194. %                       ^^^^^^^^^
  195. %     example         -SSent-Z/32
  196. %
  197. %
  198. %  Note: The -R and -S options only work if you specify that this is a
  199. %        -B or -F format Log file. CBCS log file formats are fixed.
  200. %        if you tell LOGCOUNT to expect a BinkleyTerm file it will by
  201. %        default start looking for Z-Modem Wazoo information. Of course
  202. %        you can specify any file as a Binkley or FD file and use these
  203. %        options to search for specific information, the filename will
  204. %        be expected to start exactly 2 characters after the parameter
  205. %        this allows for one 'space' Character.
  206. %
  207. %
  208. %  SPECIAL NOTE: in order for this option to work correctly you must
  209. %                have your logfile options specified in the .cfg file
  210. %                *before* this option. Command line overrides for log
  211. %                file options also will override this option.
  212. %
  213. %   EXTRA NOTE: Even though you must specify the whole 'Received' or
  214. %               'Sent' strings, the last character is insignificant, it
  215. %               must be there for the correct string size but is ignored
  216. %               by the program, this would allow all possible 'DL-?' to
  217. %               be recognized in special circumstances. So the program
  218. %               is actually looking for 'DL-' and Not 'DL-Z' because
  219. %               every protocol has it's own unique identifier.
  220. %               BinkleyTerm entries start the line with '+',
  221. %               OPUS and Maximus entries start with '=',
  222. %               FrontDoor log files start transfer entries with '*'
  223. %               Logcount will not identify entries specified as one
  224. %               of these known types unless the first character matches.
  225. %               The history files maintain the correct identifiers.
  226. %
  227. %  NOTE: Not available as a command line option.
  228. % --------------------------------------------------------------------------
  229. %
  230. %  -TN Parameter  -=> Tells logcount not to truncate lines, this may cause
  231. %                     wrap around , if your FILES.BBS descriptions are long.
  232. %                     Lines are truncated by default at 61 Characters, this
  233. %                     works perfectly with Maximus.
  234. %
  235. %       note:  this parameter could be configurable if 61 characters is not
  236. %              acceptable for all systems. Send me a message.
  237. %
  238. %   -TM# Parameter  -=> Tells Logcount not to truncate lines, and to adjust
  239. %                       any long descriptions so they display in an orderly
  240. %                       manner. Shifting the description part of the second,
  241. %                       third and fourth lines so that they start under the
  242. %                       description part of line #1, and not the download
  243. %                       count. For Maximus v1.02 ++ only. # is set to zero,
  244. %                       by defauult, specifying a number will alter where the
  245. %                       justified description will start.
  246. %
  247. %    normally Maximus is displaying FileSizes and dates, if Maximus is not
  248. %    displaying files sizes and dates, then use '-TM18'. If for any reason
  249. %    your descriptions do not align properly, try adjusting the number, -1
  250. %    will shift everything one to the right, and 1 would shift everything
  251. %    towards the left.
  252. %
  253. %   Note: Maximus v2.0x has a Max.Ctl file option to do this adjusting
  254. %         by itself. By default (in English.Mad) Maximus expects the size
  255. %         of the download counters to be 4 digits in length. FIXFBBS
  256. %         relies on the v1.02 formatting of the lines when creating it's
  257. %         catalog file. The output may be messy if the v1.02 formatting
  258. %         is not found in the files.bbs.
  259. %
  260. %
  261. %   -TR# Parameter  -=> Tells Logcount not to truncate lines, and to adjust
  262. %                       any long descriptions so they display in an orderly
  263. %                       manner. Shifting the description part of the second,
  264. %                       third and fourth lines so that they start under the
  265. %                       description part of line #1, and not the download
  266. %                       count. For Remote Access only. # is set to zero,
  267. %                       by default, specifying a number will alter where the
  268. %                       justified description will start.
  269. %
  270. %    normally RA is displaying FileSizes and dates, if RA is not
  271. %    displaying files sizes and dates, then use '-TR18'. If for any reason
  272. %    your descriptions do not align properly, try adjusting the number, -1
  273. %    will shift everything one to the right, and 1 would shift everything
  274. %    towards the left.
  275. %
  276. %   This option no longer seems to work with RA v1.11, I quess it is now
  277. %   obsolete. RA v1.11 seems to be recognizing atl #255 characters as
  278. %   normal spaces and is killing extra white space when it displays
  279. %   long file descriptions.
  280. %
  281. %  -#0  is a new option that tells Logcount to insert leading '0's in the
  282. %       download counters instead of the normal blank spacing. This will
  283. %       fix the problem of RA removing occurrences of double spacing when
  284. %       it displays descriptions of more than a single line.
  285. %
  286. %       eg..   [0037]   instead  of  [  37]   etc...
  287. %
  288. %       RA displays [  37]  as [ 37] if the File description is lengthy.
  289. %
  290. % --------------------------------------------------------------------------
  291. %
  292. %  -Q  parameter  -=> Tells logcount to operate 'Quietly', it will not
  293. %                     display it's run time options. It will still report
  294. %                     errors !
  295. %
  296. % --------------------------------------------------------------------------
  297. %
  298. %  -H  parameter  -=> tells logcount to display any runtime options and
  299. %                     if no .CFG file is found it will display the help
  300. %                     screen, it will not try to update anything.
  301. %
  302. % --------------------------------------------------------------------------
  303. %
  304. %  -H? parameter  -=> Will display the help screen, it will not display
  305. %                     any runtime options like the '-H' parameter.
  306. %
  307. % --------------------------------------------------------------------------
  308. %
  309. %  -OR Parameter  -=> Not available in the .CFG options, this will cause
  310. %                     all DOWNLOADS to be added to any existing FILES.BBS in
  311. %                     the CBCS files areas. In fact if no FILES.BBS can
  312. %                     be found then one will be created !
  313. %                     Be carefull using the -OR Orphan command line option.
  314. %                     This is useful if you ever LOSE your Files.BBS files
  315. %                     but still have backup log files, and especially if
  316. %                     you keep the History download log files. They are
  317. %                     in a  similar  format as the original CBCS Logs
  318. %                     and the BinkleyTerm entries have been changed to
  319. %                     shorten the Wazoo Z-modem entries to 4 character
  320. %                     abbreviations, using the -R and -S options can read
  321. %                     these changes ! You can easily recalculate your
  322. %                     Files.bbs files. This option is OFF by default.
  323. %
  324. % --------------------------------------------------------------------------
  325. %
  326. %  -M  parameter  -=> This tells LOGCOUNT NOT to automatically adjust areas
  327. %      <digit 1-7>    as the maximum downloaded file amount enters another
  328. %                     power of ten, but will ALWAYS Maintain this as the
  329. %                     maximum allowable inclusion. If a file has been
  330. %                     downloaded 99 times and -M2 has been used then the
  331. %                     any further downloads will always show 99, the count
  332. %                     will not increase and the size of the inclusion will
  333. %                     always remain the same. In fact this parameter will
  334. %                     force all entries in 'all' of the FILES.BBS files to
  335. %                     be this same size, regardless of how many downloads are 
  336. %                     the maximum for each different area. This option defeats
  337. %                     most of the logic involved in the program ! If you have
  338. %                     been using level '3' and then decide to start using
  339. %                     level '2' any file downloaded more than 100 times will
  340. %                     be set at the maximum for the new level, in this case
  341. %                     99 would be the maximum with level 2.
  342. %
  343. %
  344. %   -M4 would specify '[    ]' values from none to 9999
  345. %   -M3 would specify '[   ]'  values from none to 999
  346. %   -M2 would specify '[  ]'   values from none to 99
  347. %
  348. %    etc...
  349. %   -M7 is the maximum and -M1 is the minimum.
  350. %
  351. %
  352. %    By default LOGCOUNT dynamically maintains the inclusions and will adjust
  353. %    all entries in an area that has exceeded it's present level, it will
  354. %    continue to expand upwards until a maximum limit of [9999999] is reached.
  355. %    If a file that was the highest counted download is removed, the next time
  356. %    Logcount processes that area if will RECALCULATE the largest download and
  357. %    will adjust all entries in that area only. Any new file with only a
  358. %    description will also cause a rescan of the area. Filenames with NO
  359. %    description will have an 'Orphan File, No description Available' appended
  360. %    after a blank download inclusion.
  361. %
  362. %   NEW - NEW - NEW - NEW
  363. %
  364. %  -m3  C:\UPLOADS   - Overrides any 'global' inculsion size in this area
  365. %                      only. This area is 'fixed' at 3 digits. The characters
  366. %                     ':\' must be in the directory name. That's the only way
  367. %                      to distinguish a directory from a comment.
  368. %                    - Maximum of 15 directories can be listed with this
  369. %                      override option. Should be plenty.
  370. %                    - value of the number attached to the letter 'm' can be
  371. %                      higher or lower than any declared 'global' inclusion
  372. %                      size.
  373. % -m0 c:\uploads     - the 'zero' indicates that logcount should maintain
  374. %                      this area dynamically. Increasing/decreasing size
  375. %                      as necessary.
  376. %
  377. %                      All description files in this directory
  378. %                      will be included, so be carefull using this kind
  379. %                      of option if you have multiple descriptions files
  380. %                      in the same directory. (see the -@ option below).
  381. %
  382. %
  383. %
  384. % --------------------------------------------------------------------------
  385. %
  386. %    -Z<extension> -=> This is especially for SDS Distributors and other
  387. %                      network distributors, This option will accept a 3
  388. %                      character extension that is often used to attach
  389. %                      files to other Nodes. If you specify a -Z option
  390. %                      then the file will be counted as a download, BUT
  391. %                      when LOGCOUNT recognizes the next file as a special
  392. %                      extension, it will then decrement the previous entry.
  393. %                      This will take a little bit longer to do, but will
  394. %                      result in the files being sent via attaches to other
  395. %                      system nodes not being counted in your files.bbs
  396. %                      files. A maximum of 25 such attach identifiers is
  397. %                      allowed.
  398. %   Example: -Ztic
  399. %
  400. %   Special Note: If you move files around before your mailer has sent all
  401. %                 of these special '.Tic' attaches then it is very possible
  402. %                 that LOGCOUNT will not find them and will attempt to reduce
  403. %                 the previous file. This is accounted for in BinkleyTerm
  404. %                 log files, BT will report an error in the log file if is
  405. %                 supposed to send a file that it can not find. FrontDoor
  406. %                 does not report this type of error. So if you are using
  407. %                 FrontDoor and have not sent the file associated with the
  408. %                 '.Tic', then LOGCOUNT will attempt to reduce the count
  409. %                 of the previous file downloaded. If the previous file was
  410. %                 not found in a FILES.BBS or was another '.TIC' or if a
  411. %                 '.Tic' was the first file sent after a connection to a new
  412. %                 system then LOGCOUNT will not attempt to reduce a download
  413. %                 count.
  414. %
  415. % --------------------------------------------------------------------------
  416. %
  417. %   -V parameter -=>  By default LOGCOUNT will keep track of the last file
  418. %                     updated, CBCSLAST.BBS or FDRALAST.BBS, or BINKLAST.BBS
  419. %                     for the various Logs. These files will be maintained in
  420. %                     same directories as the original LOG files, what LOGCOUNT
  421. %                     will do is determine if the .LOG file is new or not, if
  422. %                     the 'time stamp' of the first entry in the file is less
  423. %                     than the last file updated, then the log file will be
  424. %                     searched till the point of the file where the last
  425. %                     successful update occurred and start processing from there.
  426. %
  427. %                     This option '-V' will turn off this feature and will
  428. %                     process the entire log, start to finish, be careful or
  429. %                     your download counts will not be accurate. If you Pack
  430. %                     or rename your log files, every night after running
  431. %                     LOGCOUNT, and there is no chance of ever reprocessing
  432. %                     the log file again, then use this option, It might
  433. %                     speed up the program a little bit.
  434. %
  435. % --------------------------------------------------------------------------
  436. %
  437. %
  438. %    -W<directory>    Optional scan of one specified directory, this should
  439. %                     be your uploads directory, all new files without
  440. %                     inclusions will have one inserted, just in case no
  441. %                     downloads have taken place in that area. LOGCOUNT
  442. %                     will automatically insert a new inclusion in NEW
  443. %                     file descriptions when it processes the area with
  444. %                     download information. This option is for inactive
  445. %                     systems, like mine.
  446. %       or
  447. %
  448. %     -W<directory/filename.ext>  in cases where FILES.BBS is not the
  449. %                                 name of the description file.
  450. % --------------------------------------------------------------------------
  451. %
  452. %
  453. %    -A<#>            by default the User name will appear starting at
  454. %                     column 60 in the history log files, if you use
  455. %                     very LONG path names for your directories, or very
  456. %                     short names, then you may want to change the position
  457. %                     where this information is written. No matter what value
  458. %                     you specify here, a MINIMUM of 3 spaces will be added
  459. %                     after the filename and before the user name, the reason
  460. %                     for this is so that that LOGCOUNT can process the
  461. %                     history files if necessary.
  462. %
  463. %    NOTE:  If you are using the '-E' options to include 'time of transfer'
  464. %           information, then you should be aware that that information
  465. %           takes up additional space in the history files, you may have
  466. %           to adjust the starting position of the user names if you change
  467. %           the amount of 'time of transfer' information. This will make the
  468. %           files line up nicely and can easily be sorted.
  469. %
  470. % --------------------------------------------------------------------------
  471. %
  472. %     -@  directory_name    drive:\path\filename.ext
  473. %
  474. %     The intent of this option is to support CDRom but it has other purposes.
  475. %     Basically what you do is supply 2 pieces of information. The first being
  476. %     the path name that will be found in the logfile being read by LOGCOUNT.
  477. %     The second being the full pathname of a file containing the file
  478. %     descriptions. Sounds simple enough eh! Not available as COMMAND line
  479. %     option, .CFG only. and check your spelling carefully.
  480. %
  481. %     for example
  482. %
  483. %     -@ C:\max\files      c:\descript\filarea.one
  484. %
  485. %     anything in a logfile with the exact path of "c:\max\files\" will be
  486. %     assumed to have it's description in the file FILEAREA.ONE in
  487. %     directory c:\descript.
  488. %
  489. %     (if and only if there is not a c:\max\files\FILES.BBS that can be
  490. %     succesfully written too!)
  491. %
  492. %     this is a direct translation.  ( c:\max\files\filename.ext  )
  493. %
  494. %     -@ C:\max*           c:\descrpt\filarea.two
  495. %        ^^^^^^
  496. %     this is an example of a WILDCARD, if the part to the left of the
  497. %     asterick ("C:\Max") can be found in the path in the logfile entry
  498. %     then the description of the filename is assumed to be in the
  499. %     specified file.
  500. %
  501. %     So things like
  502. %
  503. %     c:\max\max.exe
  504. %     c:\max\files\filename.ext
  505. %     c:\max\olr\node01\maximus.qwk
  506. %     c:\maximus\files\filename.ext
  507. %     c:\max\etc.....
  508. %     ^^^^^^
  509. %     are all going to have their descriptions in the file
  510. %     c:\descrpt\filearea.two
  511. %
  512. %     (if and only if there is not a FILES.BBS in the specific
  513. %     directory that can be succesfully written too!)
  514. %
  515. %
  516. %     finally
  517. %
  518. %     -@ *  c:\max\files.bbs
  519. %
  520. %     Usually this will be your very last "-@' option. The single asterick
  521. %     indicates that any file that can not be found in a files.bbs in the
  522. %     directory indicated as it's download path, or if all other directory
  523. %     translations fail, then this is the last place to look for a description
  524. %     for the file. -OR Orphans are sure to show up in here.
  525. %
  526. %     The translatable directory stuff need not to be too exact, but the
  527. %     filenames with the descriptions must be exact "drive:\path\filename.ext"
  528. %     entries. It's a good idea to ensure that these files really exist. The
  529. %     usual names for these files is "FILES.BBS" but any legal DOS filename
  530. %     is acceptable. These files can contain full drive/path/filenames as well
  531. %     as simple filenames and of course the associated descriptions.
  532. %
  533. %     Maximum of 75 translatables. (length 63 chars maximum.)
  534. %     use wildcard translations....
  535. %
  536. % --------------------------------------------------------------------------
  537. %
  538. %   NEW - NEW - NEW - NEW
  539. %
  540. %
  541. %     -MaxFiles  c:\max   ;Maxfiles.Idx, Area.Dat,and Area.Ndx are here!
  542. %
  543. %
  544. %     this option allows LOGCOUNT to look up SIMPLE file names in the
  545. %     database files compiled with FB.EXE. It will find the simple
  546. %     names and find a full path if possible. Specifying MaxFiles tells
  547. %     Logcount to lookfor Maxfiles.Idx in the current directory and expects
  548. %     to find AREA.NDX and AREA.DAT in the same default directory. If you
  549. %     specify Maxfiles with a Path (eg MaxFiles  C:\Max) then Logcount will
  550. %     look in the specified directory for the Maximus data files.
  551. %
  552. %
  553. %     This may be usefull if your mailer does not supply full path
  554. %     information with it's file requests. D'Bridge for example.
  555. %     You may have to investigate the -r and -s options to get
  556. %     Logcount to look for the correct receive and send instructions,
  557. %     and have it use the maximus files to determine the path to your
  558. %     files.bbs files or FILELIST files in their various directories.
  559. %
  560. % --------------------------------------------------------------------------
  561. %
  562. %     -CleanSpace
  563. %
  564. %     this option tells logcount not to add extra white space to the
  565. %     filenames in the FILELIST (FILES.BBS). Normally all simple names
  566. %     are padded to 15 characters, OPUS used to do that and maybe
  567. %     Maximus does, not sure. This options disables this function
  568. %     only if the files.bbs entry has a path in the filename or has
  569. %     any hidden characters (eg. /bt, /b, /t) before the counter.
  570. %     Normal simple names are still padded to 15 characters so that
  571. %     description fields are more easily detectable by human beings.
  572. %
  573. %
  574. % --------------------------------------------------------------------------
  575. %  Advanced features.........
  576. % --------------------------------------------------------------------------
  577. %
  578. %
  579. %     -o_Words 2
  580. %
  581. %     this tells logcount to expect the download count as the third word
  582. %     in the description field. That is there are 2 extra words on the
  583. %     line before the download count. if file descriptions include filesize
  584. %     or date then the download is not the first thing in the description.
  585. %     If Logcount is set for -TM#  or -TR# then LOGCOUNT will adjust the
  586. %     descriptions so they appear exactly as a normal file listings as
  587. %     as they do when maximus is displaying `Automatic Date'. Must be
  588. %     either 1 or 2 words maximum. 2 for size and date, etc...
  589. %
  590. %     set FILELIST MARGIN 31  in Max.Ctl if description contains size and
  591. %                             date.
  592. %
  593. %     If you set -TN then you'll have to adjust the appropriate variable
  594. %     of Maximus to get the descriptions lining up properly. And you'll
  595. %     also have set a predetermined maximum counter size limit.
  596. %
  597. %
  598. %     -o_Word1 7
  599. %
  600. %     This tells LOGCOUNT to format your first word to 7 characters
  601. %     oridnary blank space will be added if you have a colour defined
  602. %     for the first word, if not then alternate blank, character 255
  603. %     will be used. This is usefull if the first word is `filesize',
  604. %     a variable length. The word will be right justified in it's field
  605. %     The date (o_word2) already has a fixed length format so that word
  606. %     needs no adjustment.
  607. %     
  608. %
  609. %     if we know there are 2 words we can also define the colours we
  610. %     want each word to be.
  611. %
  612. %     -c_Word1     [magenta]  word1 = size..
  613. %     -c_Word2  é   [green]    word2 = date..
  614. %
  615. %      don't try to set "-c_word2"  if "-o_words" = 1  !
  616. %
  617. %     -c_Word3  ä   [red]
  618. %
  619. %     word3 is optional but usefull, if a filelist has a non numeric
  620. %     filesize (1st word) then LOGCOUNT will insert this colour and
  621. %     will not treat this as a real filesize and date using the other
  622. %     specified colours.
  623. %
  624. %     if these advanced features are in use, LOGCOUNT can operate
  625. %     on normal files.bbs listing (with only filenames and descriptions)
  626. %     and other files with `WORDS' (eg. size and date) as the first
  627. %     part of the description at the same time. If a normal description
  628. %     has no extra words before the description then LOGCOUNT will not
  629. %     attempt to add anything into those words. If there are more words
  630. %     found than defined then the whole thing will be considered part of
  631. %     the description.
  632. %
  633. %
  634. %
  635. %
  636. % --------------------------------------------------------------------------
  637. %  Final feature:  Maximus and OPUS allow entries in the FILES.BBS to
  638. %                  contain Wildcards ! Yes it's true. Maximus is very
  639. %                  gracious allowing '?' and '*' wildcards. I don't
  640. %                  know if OPUS allows both wildcard identifiers.
  641. %
  642. %                  This allows you to place files that have constantly
  643. %                  changing names if the files areas, the FILES.BBS entry
  644. %                  would say NODELIST.A?? and the CBCS would display the
  645. %                  real name of the file, NODELIST.A73. LOGCOUNT only
  646. %                  understands the use of '?' wildcards, it does not
  647. %                  understand the '*' and if it ever encounters one it
  648. %                  will ignore it. There is a perfectly good explanation
  649. %                  for this. It's much easier to check for '?' wildcards.
  650. %                  LOGCOUNT will check for these wildcards '?' and will
  651. %                  update the wildcard FILES.BBS entries.
  652. %
  653. %
  654. %  Absolute last feature, option, I really don't like this one !!!!
  655. %
  656. %    -NO            This turns off the main function of the program,
  657. %                   updating the files.bbs with the download counts.
  658. %                   Of course if you disable the updating of the
  659. %                   FILES.BBS files, then all parameters and functions
  660. %                   specific to the FILES.BBS will also be disabled.
  661. %                   I have included this for those of you who wish to
  662. %                   use the History log file features only. Registered
  663. %                   users get more features including a comprehensive
  664. %                   database option, complete system monitoring, including
  665. %                   special processing of 'Tic' and 'Fle' file attaches.
  666. %
  667. %
  668. % --------------------------------------------------------------------------
  669. % --------------------------------------------------------------------------
  670. % --------------------------------------------------------------------------
  671. %
  672. %
  673. %    Example.  LOGCOUNT.CFG file.
  674.  
  675.   -ltest.log               %CBCS Logfile, starts with -L
  676. %
  677. % -x(                      %left side 'inclusion' character , default is '['
  678. % -y)                      %right side    "          "          "        ']'
  679. % -m3                      %always maintain 3 digit counts.
  680. %
  681. % These above three options may be needed if you have been previously
  682. % using another popular Download counting utility ! The '-M3' option is
  683. % truly optional, but the inclusion characters must match what already
  684. % exist in your FILES.BBS, otherwise all entries will be considered as
  685. % New entries and will given new inclusions. Be Careful, use the -H option.
  686. %
  687. %
  688.   -dc:\logs\download.log      % history downloads.
  689.   -uc:\logs\uploads.log       % history uploads.
  690.   -wd:\f\uploads\files.bbs    % Scan uploads, not very busy around this BBS.
  691.   -A50                        % Short pathnames, so start user name at column 50
  692. % -TM18                       % Maximus 3 line descriptions and NO file info
  693.   -TM                         % 3 Line descriptions, FILESIZE/DATE displayed.
  694.   -JMaximus.Qwk               % Keep this filename out of history logs.
  695.   -JMaximus.Rep               % Keep this filename out of history logs.
  696. %
  697.   -@ c:\max\olr\node01  c:\max\olr\files.bbs
  698. %
  699. % ( the above option is useful because maximus is continuously creating     )
  700. % ( and removing this directory. the -OR option does not create directories )
  701. % ( but using a directory/filename translation allows you to monitor these  )
  702. % ( QWK transfers. )
  703.   -@ g:*  c:\max\files.lst    % All files on G: have descripts in files.lst
  704.   -@ *    c:\max\unknown.lst  % last chance description file.
  705. %
  706. %
  707. %   These parameters tell logcount to use special 'bracket Characters'
  708. %   and that the  default log is a  CBCS type log file call TEST.LOG If no
  709. %   path information is given in the name, it will look for it in the current
  710. %   directory, not where LOGCOUNT.EXE is, LOGCOUNT can be anywhere,
  711. %   preferably some where on the DOS Path. Seperate Uploads and downloads
  712. %   history files will be maintained. LOGCOUNT will keep a CBCSLAST.BBS
  713. %   file in the same directory as TEST.LOG, so if the file is updated again
  714. %   it will only process newer downloads, and uploads.
  715. %
  716. %   If you were now to execute LOGCOUNT -U -D -Bc:\binkley\binkley.log -Ztic
  717. %   then the 'blank' history files option would turn OFF the history files
  718. %   option. The -B parameter tells LOGCOUNT to ignore the .CFG -L<CBCS> log
  719. %   file options and use the default BinkleyTerm Wazoo type entries. The
  720. %   special extension of '.TIC' would cause previous files to be 'reduced'
  721. %   since their previous increment was due to a file attach, and should not
  722. %   be counted as a download.
  723. %
  724. % CopyRight (c) RAFware CBCSystems 1990.
  725. %
  726. % send donations ( $10.00 ), suggestions, or snail mail to
  727. %
  728. %          Rodney A. Fraser
  729. %          6429 Halifax Steet,
  730. %          Burnaby, B.C.
  731. %          V5B 2P7, CANADA.
  732. %
  733. % enclose 5", 360K floppy in self addressed envelope and
  734. % I will send Registered version.
  735. %
  736.